Get Presentation

Retrieve the status of a presentation generation task

Base URL

https://appdev.mexus.cc

Authentication

All API requests require an API Key included in the Header. If you don't have one, create it on the API Tokens page:

Authorization: Bearer YOUR_API_KEY

Endpoint

GET /api/v1/presentation/{taskId}
Authorization: Bearer YOUR_API_KEY

Path Parameters

Parameter	Type	Required	Description
taskId	number	Yes	The task ID returned from the presentation generation request

Response

The response will vary depending on the status of the presentation generation task.

Response Structure

Status	Response Fields
processing	id, status, message
success	id, status, url, filename, fileSize

Field Descriptions

Field	Type	Description
id	number	The task ID
status	string	Current status of the task: processing, success, error, or unknown
message	string	A human-readable message providing more information about the status
url	string	Download URL for the generated presentation (only present for successful tasks)
filename	string	Name of the generated presentation file (only present for successful tasks)
fileSize	number	Size of the generated file in bytes (only present for successful tasks)

Examples

Processing Status Response

{
  "id": 123456,
  "status": "processing",
  "message": "Export is in progress"
}

Success Status Response

{
  "id": 123456,
  "status": "success",
  "url": "https://storage.example.com/presentations/annual_report_2025.pptx",
  "filename": "annual_report_2025.pptx",
  "fileSize": 2458621
}

Usage Example

// JavaScript example
const checkPresentationStatus = async (taskId) => {
  const response = await fetch(`https://api.example.com/api/v1/presentation/${taskId}`, {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });
  
  const data = await response.json();
  
  if (data.status !== 'success') {
    console.log('Presentation is still being generated...');
    return;
  }
  
  // download the presentation
  const a = document.createElement("a");
  a.href = data.url;
  a.download = "presentation.pptx";
  document.body.appendChild(a);
  a.click();
  document.body.removeChild(a);
  
  return data;
};